home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 2 / AACD 2.iso / AACD / Online / TimeLord / TimeLord.readme < prev    next >
Encoding:
Text File  |  1999-06-28  |  6.8 KB  |  139 lines
  1. Short:    OS timeclock resync tool (version 2.20)
  2. Author:   granta@mindspring.com (Grant Allen)
  3. Uploader: granta@mindspring.com (Grant Allen)
  4. Type:     comm/net
  5.  
  6. TimeLord: the system time manager from the western province
  7. on Gallifrey (otherwise known as the U.S. of A.). It will
  8. re-sync your system battery clock and the standard OS clock
  9. with that of an internet host. This tool can be run both
  10. from the command line and from the WorkBench. When run from
  11. the workbench, the GUI has several additional features not
  12. available to the transient command:
  13.  
  14. 1) Window can be shrunk and moved off to the side allowing
  15.    it to be run as a background daemon.
  16. 2) You can set up a list of hosts with which to re-sync.
  17.    You can manually select a host from the list, or have
  18.    it sequence down through the list, trying each host in
  19.    sequence, until it either successfully connects with
  20.    one or has failed to connect with all of the hosts
  21.    in the list. You can also prioritize the entries by
  22.    moving your favorite entry/entries to the top of the
  23.    list. It will always re-sync from the top of the list
  24.    down. Included are 3 hosts which connect to 3 separate
  25.    addresses at the U.S. Naval Observatory Atomic Clock
  26.    in Greenwich, England. I have included all 3 because
  27.    not all of them are always available (I have had trouble,
  28.    from time to time, connecting with each one).
  29. 3) Can be configured to re-sync the clocks at a regular
  30.    interval. It is currently configured to continually
  31.    re-sync the system clocks at 10 minute intervals while
  32.    you are on line. When this feature kicks in to perform
  33.    a re-sync, it attempts to re-sync using the "sequence
  34.    through hosts" feature mentioned in #2. This automatic
  35.    re-sync feature can be disabled by setting the re-sync
  36.    interval to 0 minutes.
  37.  
  38.  This program is a full object oriented, C++ program, and
  39. NOT A COMPILED SCRIPT!!! As such, it uses BSD socket calls, rather
  40. than using the TCP: device. It has full resource management built
  41. in, which means it cleans up after itself, making sure
  42. allocated memory is freed, and all sockets are closed when
  43. complete. This utility was written from scratch using a
  44. foundation class system I have written.
  45.  
  46.  A partial list of features provided by this class system include:
  47. 1) TCP support. This TCP class now uses the 'bsdsocket.library' calls,
  48.    (it originally only used the 'tsocket.library' calls) and is
  49.    therefore compatible with any TCP stack that supports this library
  50.    (AmiTCP, TermiteTCP, ...). This class DOES NOT USE THE TCP:
  51.    DEVICE!!! It should completely ignore this device, and therefore
  52.    won't care if it is mounted. [It was difficult getting the
  53.    'bsdsocket.library' calls to work correctly as the 'TermiteTCP'
  54.    SDK did not come with the headers to this library, even though
  55.    it had version 4.2 of this library built in, so I had to build
  56.    them using mostly trial and error].
  57. 2) full resource management
  58. 3) class which provides full management of child processes or threads
  59.    with message ports to allow communication between parent/child
  60. 4) full GUI class system providing support for all controls (including
  61.    GadTools, BOOPSI, and DataTypes), windows and virtual screens
  62. 5) all GUI objects support arrays, so you can have arrays of controls
  63.    or even windows
  64. 6) full GUI message dispatcher built in so you don't have to
  65.    worry about this. you simply have to add message handlers
  66.    for those messages which you want to handle. interpretation,
  67.    processing, and replying to messages is all handled internally
  68.    for you. this works similarly to a package called "Visual C++" found
  69.    on another operating system [the name of which escapes me right now :)].
  70. 7) interprocess communication port class
  71. 8) high performance string class. they are also managed resources so that if
  72.    any are not destructed upon exit from the program, then the manager will
  73.    do it for you, thus making sure all memory allocated to them are freed.
  74. 9) full set of signal handling classes
  75. 10) full featured date class providing program control over how the operating
  76.     system handles daylight savings time (from completely off, to calculate
  77.     daylight savings, but don't adjust initially, to fully automated
  78.     calculation of daylight savings start/end dates and adjust time
  79.     accordingly. Also fully handles timezone changes, taking daylight savings
  80.     into account. Also includes date string parser/interpreter which can
  81.     input a date in virtually any format, using as little date information
  82.     as possible.
  83. 11) easy timer and clock classes, allowing easy access to the system clock
  84.     (timer device), and the battery backed up clock (battclock resource).
  85.     it also supports multi-timer-events allowing you to send and manage
  86.     multiple timer events using the same timer object. full cleanup is
  87.     provided to cancel any outstanding timer events when the object is
  88.     destructed. each object is individual, allowing you to have as many
  89.     separate timer/clock objects as you may need.
  90.  
  91.  All of these classes, and the above program were were
  92. designed and compiled using SAS C++ 6.57. This utility REQUIRES:
  93. a 68030+ CPU, and has been extensively tested on OS 3.1. It may
  94. possibly run on OS 2.0+ (though I don't have any way of testing
  95. for this), but it probably won't run on pre-2.0 as it uses many
  96. functions which use "Tags" and it uses several GadTools gadgets,
  97. which weren't "officially" supported prior to 2.0. It also uses
  98. the 'battclock.resource' which I believe didn't exist prior to
  99. OS 2.0.
  100.  
  101.  Revision History:
  102. v2.00:    first release. used Termite TCP only.
  103. v2.10:  second release. altered to use 'bsdsocket.library' calls.
  104. v2.20:  added Hotkeys. Now, in addition to using <TAB>/<SHIFT><TAB>
  105.         to go from gadget to gadget, each and every control as a
  106.     special hotkey sequence associated with it. now, you can
  107.     do everything without even touching the mouse. HotKeys are
  108.     documented in the built-in quick help.
  109. v2.30:  looking at implementing support for INet 225 into my foundation
  110.         system socket class. This would allow any program based on this
  111.     class system to internally support both 'bsdsocket.library'
  112.     AND the INet 225 'socket.library'.
  113.  
  114. -----------------------------------
  115.  
  116. The latest version of this tool, and many others developed by me,
  117. can be found at my web site at:
  118.  
  119. http://www.mindspring.com/~granta/
  120.  
  121. -----------------------------------
  122.  
  123. Please don't break up this archive if you upload it elsewhere.
  124.  
  125. -----------------------------------
  126.  
  127. You are not allowed to charge for the distribution of this
  128. utility. I retain all rights to it, but I am not charging any
  129. fees for its use. It is fully operational (not crippleware),
  130. and contains NO nag screens!!! All help is built in. To run
  131. the GUI interface, simply run it without arguments, or click
  132. on the 'TimeLord' icon.
  133.  
  134. -----------------------------------
  135.  
  136. Please drop me a message letting me know what you think of it...
  137. suggestions, bugs, ...
  138.  
  139.